home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / auxout.arc / AUXOUT.MAN < prev    next >
Text File  |  1988-07-06  |  4KB  |  83 lines
  1.         AUXOUT                ST-UNIX User's Manual                 AUXOUT
  2.  
  3.  
  4.  
  5.        COMMAND
  6.             auxout - send controlled strings to the serial port.
  7.  
  8.        FORMAT
  9.             auxout [%Sn][%Cn][%Fn][<str>.][[%T<str>.|%U<str>.|%Dn|%Wc]...].
  10.  
  11.        DESCRIPTION
  12.             pAuxoutq sends controlled sequences of strings to the serial
  13.             port.  Its primary purpose is to allow login handshaking with 
  14.             host machines.  It may also be used to set modem parameters, and 
  15.             the ST serial port configuration.  
  16.  
  17.             The command tail of pAuxoutq is a sequence of commands.
  18.             Except in one case each command begins with '%'.  Command
  19.             types are described as follows.
  20.  
  21.        OPTIONS
  22.             %S - sets the speed of the serial port.
  23.                  if  n = 1,4,7 the speed is set to 9600, 2400, and
  24.                          1200 baud, respectively.
  25.  
  26.             %C - sets the serial port configuration.
  27.                  if  n = 0,1,2 the configuration is set to 1N8, 1E7,
  28.                          and 1E8, respectively.
  29.  
  30.             %F - sets the flow control.
  31.                  if  n = 0,1,2 the flow is set to off,^S^Q, and
  32.                          CTS/RTS, respectively.
  33.  
  34.             %D - delays executing the next command for a specified time.
  35.                  if  n = 1,2,3... the delay is about 1/2 sec.,
  36.                          1 sec., 3/2 sec...
  37.  
  38.             %T - sends the string <str> to the modem where <str>
  39.                  is any ascii string.  In <str>, the "~" character
  40.                  causes a blank to be sent.  This is to allow auxout
  41.                  command tails in *.g files to be accepted by the gulam
  42.                  shell. The string to be sent must be terminated by a
  43.                  period '.' or else a much longer and crazy string will
  44.                  be sent.  
  45.  
  46.             %U - like %T except that all lower case caracters in <str> are
  47.                  converted to upper case before being sent.  Must also be
  48.                  terminated with a period '.'.
  49.  
  50.             %W - waits for the character c to be received by the serial
  51.                  port before the next command is executed.  This command
  52.                  does not distinguish between upper case and lower case.
  53.                  Pressing <return> while waiting escapes from the entire 
  54.                  command sequence.
  55.  
  56.        EXAMPLES
  57.            
  58.             auxout %C0. 
  59.  
  60.                - sets the port configuration to 1N8.
  61.  
  62.             auxout %S1atf1.%Wk%Tat&M4dp3356221.%WQ%D1%Tfranco.%W:%Tpass.
  63.  
  64.                - sets the speed to 9600 baud, sets the modem to full duplex
  65.                  (Hayes commands), waits for the modem to respond with 'ok',
  66.                  dials the telephone number '3356221', waits for a response 
  67.                  of 'Q' from the remote modem, waits 1/2 second, sends
  68.                  'franco', waits for the password prompt ':', sends the 
  69.                  password 'pass'.
  70.  
  71.        NOTES
  72.  
  73.             1.  The entire command tail must be terminated with a period.
  74.             2.  The first <str> string that is transmitted is not preceeded
  75.                 by %T or %U.  All following <str> strings are.
  76.             3.  The first <str> string is transmitted as though preceeded
  77.                 by %T.
  78.             4.  A newline character is automatically sent after each
  79.                 transmitted <str> string.
  80.            
  81.  
  82.    Printed 6/30/88                                                Page 1
  83.